





‘Guide To The 
ee New Features 


























































































Customer Satisfaction 


A RS ee a ok 
If you discover physical defects in the manuals distributed with an Apple product or in the media on 
which a software productis distributed, Apple will replace the documentation fe) @nt=elt-e-\uare) 
charge to you during the 90-day period after you purchased the je}gele (le) a 


In addition, if Apple releases a corrective update to a software product during the 90-day period 
after you purchased the software, Apple will replace the applicable diskettes and documentation 
with the revised version at no charge to you during the six months after the date of purchase. 


In some countries the replacement period may be different: check with your authorized Apple 
dealer. Return any item to be replaced with proof of purchase to Apple or an authorized Apple 
dealer. 


Limitation on Warranties and Liability 


Even though Apple has tested the software described in this manual and reviewed its contents, 
neither Apple nor its software suppliers make any warranty or representation, either express or 
implied, with respect to this manual or to the software described in this manual, their quality, 
performance, merchantability, or fitness for any particular purpose. As a result, this software and 
manual are sold “as is”, and you the purchaser are assuming the entire risk as to their quality and. 
performance. In no event will Apple or its software suppliers be liable for Cole} au are|i¢-Leiaaaret(ol=lalt-l 
or consequential damages resulting from any defect in the software or manual, even if they have 
been advised of the possibility of such damages. In particular, they shall have no UE lollliavacelgr-laNvg 
Programs or data stored in or used with Apple products, including the costs of recovering or 
reproducing these programs or data. Some states do not allow the exclusion or limitation of implied 
warranties or liability for incidental or consequential damages, so the above limitation or exclusion 
may not apply to you. 


Copyright 

— ae 
This manual and the software (computer programs) described in it are fefe) o)"Zare]al (Toll ohV#N of e]{-Kol dl o)Vg 
Apple’s software suppliers, with all rights reserved. Under the copyright laws, this manual or the 
programs may not be copied, in whole or part, without the written consent of Apple, exceptin the 
normal use of the software or to make a backup copy. This exception does not allow copies to be 
made for others, whether or not sold, but all of the material purchased (with all backup copies) may 
be sold, given or loaned to another person. Under the law, copying includes translating into 
another language. 


You may use the software on any computer owned by you but extra (ove) o[-t-Yer-lalatol@ o\-aunl-(e(-Ne)m alts) 
purpose. For some products, a multi-use license may be purchased to allow the software tobe 
used on more than one computer owned by the purchaser, including a shared-disk system. 
(Contact your authorized Apple dealer for information on multi-use licenses.) 


Product Revisions 


Apple cannot guarantee that you will receive notice of a revision to the software described in this 
manual, even if you have returned a registration card received with the product. You should 
periodically check with your authorized Apple Dealer. 


© Apple Computer, Inc. 1982 
20525 Mariani Avenue 
Cupertino, California 95014 


Apple and the Apple logo are registered trademarks of Apple Computer, Inc. 
Simultaneously published in the U.S.A and Canada. 
Reorder Apple Product Number A2F2114 


Written by Joe Meyers of Apple PCS Publications Department 
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A Guide to the New 
Features of the Apple Ile 
Computer 


Introduction 


This guide describes, as briefly and completely as possible, the new 
features of the Apple Ile computer. The Apple Ile is a new addition to 
the Apple II series of computers; in fact, it is a refined and improved 
Apple II Plus. 


The information in this guide is divided into two sections: 


@ new features, grouped under five headings—keyboard, display, 
back panel, main logic board, and firmware 


e effects of the new features on the user, and on software and hard- 
ware designed for use with the Apple II or II Plus 


This guide is the first of a Product Support Series intended for Apple 
dealers and sales representatives. Two other guides are currently 
available in this series: 


Apple lle Cable and Connector Guide 
Apple Product Number A2F2115 


Apple lle Design Guidelines 
Apple Product Number A2F2116 


The Cable and Connector Guide explains how to obtain and install 
connectors for attaching an Apple Ile to any Apple II peripheral 
device. 


The Design Guidelines provide hardware, software and firmware de- 
velopers with detailed recommendations for tailoring their products to 
Apple II Series devices and users. 





This guide makes reference to four other Apple Ile manuals: 


Apple Ile Owner’s Manual 
Apple Product Number A2L2001 


Apple Ile Reference Manual 
Apple Product Number A2L2005 


Apple Ile 80-Column Card Manual 
Apple Product Number A2L2006 


Apple lle Extended 80-Column Text Card Supplement 
Apple Product Number A2L2007 


For definitions of terms, refer to the glossaries of the first two man- 
uals cited above. 


Use the index to locate individual topics discussed in this guide. 


New Features 


The Apple lle is an enhanced version of the Apple II Plus computer. It 
was designed to improve the performance and flexibility of the Apple 
Il family of computers, while remaining compatible with virtually all 
software and hardware that work with the Apple II and II Plus. 





The new features of the Apple Ile fall into five broad categories: 


1. Enhanced keyboard, including the full ASCII character set 


2. Improved video display capabilities, including both uppercase and 
lowercase and easy expandability to display of 80 characters per 
line 


3. Redesigned back panel, which meets FCC requirements and pro- 
vides for standardized connection of a display device, hand con- 
trols, and up to 12 other peripheral devices 


4. Fewer parts on the main logic board; built-in 64K random access 
memory (RAM) and 16K read-only memory (ROM); new slot 
arrangement 


5. Improved firmware, including new video handling routines and 
built-in self-tests 




















Keyboard 





























The Apple Ile keyboard is laid out like the most widely used electric 
typewriter keyboards, and now has 63 keys. Here are the new key- 
board's features: 


full ASCII character set, including 96 printable characters and all 
32 control characters 


lowercase as well as uppercase 


a key to shift letters to uppercase and leave other keys 
unaffected; with this key locked, the Apple lle keyboard functions 
almost the same as an Apple II Plus keyboard 


auto-repeat feature on each key: holding down any key for more 
than a second causes the key to repeat 


new cursor-movement keys: (1), 1) and 

new key 

two new special-purpose keys (() and (@)) 

relocated key to reduce possibility of accidental loss of data 








Table 1. Characters Available on the 
Apple lle Keyboard 


Table 2. Characters Available on the 
Apple Il and II Plus Keyboard 














Group: Characters Available: 

Control @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] ~_ 
Special * eeeG eee wee. (O01 234516 7 89 2: (=)? 
Uppercase @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] * — 
Lowercase ‘abcdefghijkl mnopqrstuvwxyz{ |}~DEL 


* The first special character is the SPACE character. 


Group: Characters Available: 


Control All except (ContrRoL)-(\) and (conTrot)-—) ((EScAPE) key provides (CONTROL)-(1)) 








Special All of this group of characters are available 
Uppercase Allexcept[ \ and — 


Lowercase None of this group of characters are available 





For further information about the Apple Ile keyboard and its features, 
consult Chapter 2 of the Owner’s Manual, and Chapter 2 of the 
Reference Manual. 





Video Display 

The Apple Ile has an improved video display, including: 

@ the Apple Il and II Plus character set, with the addition of 
lowercase 


@ analternate character set with full uppercase and lowercase in 
normal and inverse fonts (but no lowercase flashing display) 





Openings numbered 1 through 4 are 
usually reserved for attachment of disk 
drives. Openings 5, 8, 11 and 12 are for 
peripheral devices requiring 25-pin 

: connectors. Openings 6, 7, 9 and 10 are 
for 9-pin connectors (and for 5-pin DIN- 
type connectors). 











@ easy, inexpensive expandability to 80-column text display using 
the Apple Ile 80-Column Text Card 


@ additional display functions available from the keyboard (using 
escape sequences) or from programs (using control characters) 


@ new software switches for controlling the video display; programs 
can now read them as well as write (change) them 


For a description of the two character sets and how to switch 

between them, see Chapters 2 and 3, respectively, of the Apple lle 
Reference Manual. The Apple Ile 80-Column Text Card and its es- 
cape and control characters are described in the Apple Ile 80-Col- 
umn Text Card Manual and in Chapter 2 of the Reference Manual. 


The Reference Manual describes the software switches in 
Chapter 2. 





Redesigned Back Panel 





The Apple Ile has a metal back panel with 12 rectangular openings 
instead of the notches found on the Apple II and II Plus. This new 
back panel features small diagrams of the devices you can attach to 
each of the four built-in connectors, and specially arranged openings 
for disk drive cables, 9-pin and 25-pin D-type connectors. 


The back panel is fully described in Chapter 1 of the Apple Ile Refer- 
ence Manual. (For product numbers, refer to the first section of this 
guide.) 





Modified Main Logic Board | 


The Apple Ile main logic board has several noteworthy features: 


e@ three new custom integrated circuit chips, which make the com- 
puter easier to service, reduce power consumption and increase 
reliability 


@ built-in 64K (65,536) bytes of main memory in RAM, including the 
functional equivalent of the language card (formerly an extra-cost 
option) 


@ built-in 16K (16,384) bytes of firmware in read-only memory 
(ROM), including a set of self-tests (the Apple II and II Plus had 
only 12K of ROM) 


@ anew AUX (auxiliary) CONNECTOR slot with 60 pins, making 
(along with the normal 50-pin slots) virtually every useful computer 
signal available for use by peripheral devices; this slot is for the 
Apple Ile 80-Column Text Card and other special products 


@ aninternal power-on light to remind you not to connect or discon- 
nect anything inside the computer while the power switch is on 


The Owner's Manual describes the physical features of the Apple Ile 
in Chapter 1. For details regarding the electrical and logical charac- 
teristics of the Apple Ile, consult the Reference Manual. 





Additional Firmware 

Besides the video and monitor programs resident in all Apple II and II 
Plus ROMs, the Apple Ile has new firmware: 

@ 80-column display handling routines 


@ built-in self-tests invocable using the (#) key with (CONTROL)-(RESET) 


@ anew full reset invocable from the keyboard using the (@) key with 
(CONTROL)-(RESET); this provides a convenient alternative to turning 
the power off and on again to restart the system 





The 80-column display handling routines are described in the 
Reference Manual; new video display firmware features and how to 
use them are described both in the Reference Manual and in the 
Apple Ile 80-Column Text Card Manual. 


The Owner's Manual describes how to invoke the self-tests and the 
reset functions; the Reference Manual explains how they work. 








Effects of New Features 

This section deals with the effects that the differences between the 
Apple lle and the Apple II or II Plus have on: 

the layout and use of the keyboard 

the characters available for display 


connection methods at the back panel 


connection methods inside the case 
e use of self-tests and reset 


@ interactions of the computer with software 


The following six charts discuss these effects and what to do about 
them. Some of these effects occur only if you have installed an Apple 
lle 80-Column Card; such effects are so marked. 


The first five charts correspond to the lists of features and further 
reading presented in the first section of this guide. For further infor- 
mation, refer to the manuals cited in those lists and study the Apple 
lle data sheets. Technical support is also available from your Apple 
Regional Support Center. In the case of undocumented problems 
with software and hardware from a manufacturer other than Apple 
Computer, Inc., notify the manufacturer directly. 

















nn Changes to Keyboard 





Feature involved 


Full ASCII character set, 
including all printing characters. 


Table 3. New Printable Characters 





GEBAREADESHEES 
{ } | 

Pm Jojwhefalr}yjulifofeti fs]. 

om Tatsfotefotapat xtc] i]? | mm | 





2 
< > : 
caps | ~ 


Effect What to Do 


Some existing products may not You may have to avoid using 
take advantage of, or be able to some or all of the characters 
recognize, the new characters. listed in Table 3. 


Character Name 

athruz lowercase alphabet 

[ opening square bracket 
SX reverse slant (backslash) 


opening single quote 


{ opening brace 
| vertical line 

} closing brace 
~ tilde 

DEL delete (rubout) 
_ underline 


Note: The symbol ] (closing square bracket) was available as (SHiFT)-(w) 
on the Apple II and II Plus, but was not marked on the keyboard. 


Feature involved 


Keyboard now has 63 keys, 
arranged in the format most 
popular among touch typists. 


The caret (4), at-sign (@) and 
closing square bracket (]) are 
now on non-alphabetic keys so 
that all control characters work 
with both uppercase and 
lowercase keystrokes. 


Lowercase letters are available 
on the Apple lle. 


Effect 


About a dozen symbols have 
moved to new positions. 


Many manuals specify * as 
(SHIFT)-(N), @ as (SHIFT)-(P), and 
] as GHIFT)-(¥); that is, they 
specify the associated letter 
keys instead of the characters 
themselves. 


Programs written to run under 
DOS or in BASIC do not 
recognize lowercase letters 
(except between quotation 
marks). 





What to Do 


People used to typing on an 
Apple II or I] Plus may have to 
adjust to this. 


Some documentation may be 
wrong or misleading as a result 
of the new character positions. 


The user must take this change 
into account, especially when 
typing control characters. For 
example, (GONTROL)-(SHIFT)-(P) is 
really (CONTROL)-(@), wherever 
that appears on the keyboard 
involved. 


The user must be careful to use 
or when 
typing commands to DOS or 
writing BASIC programs. 


Programmer note: Apple Ile firmware supports an uppercase-restrict 
mode that forces uppercase except between double quotation 
marks. This feature is described in the Apple lle 80-Column Text 


Card Manual. 





Feature involved 


Each character key has the auto- 
repeat feature. 


Effect 
There is no longer a key. 


The user may inadvertently 
cause a repeated character. 


What to Do 


To cause a key to repeat its 
character, press it and hold it 
down. 


Users should be aware of the 
auto-repeat feature and not let 
their fingers rest too long on the 
keys. 


Note: Pressing a second key while a key is repeating may cause the 
second key’s character to begin appearing instead of the first. 


Note: Holding down the key a bit too long when starting an escape 
sequence may actually cancel the escape sequence that the user thought 


was underway. 





Feature involved 


There are four new control keys 
on the Apple lle. 


The Apple Ile has an@ and @) 
key as special-purpose keys. 
Among other uses, these keys 
can be used instead of the 
pushbuttons of hand controls 
#0 and #1, respectively. 


There is no longer a way to 
actuate without pressing 
(CONTROL). This is a software 
safety feature. 





Effect 


Not all programs written for 
the Apple II recognize the 
three new cursor movement 
keys ((1), ) and Gas)) and the 
new key. 


Some manufacturers make hand 
controls with pushbuttons that 
are normally closed, or that can 
be locked in a closed position. 
This can cause a (CONTROL)-(RESET) 
to invoke the self-tests instead of 
a reset. 


Pressing alone has no 
effect. 





What to Do 


Use the keystrokes designated 
in the program documentation to 
move the cursor up or down or to 
the next tab setting, or to delete 
characters. 


Make sure the hand control 
pushbuttons are off or discon- 
nected when you are not using 
them, and especially when 
you press or turn on the 
Apple lle power switch. 


Users must remember to press 
(CONTROL)-(RESET), 





Video Display 








Feature involved 


The Monitor in firmware has new 
code to support many new 
features. 


The 80-column firmware has to 
execute many more program 
steps than the 40-column 
firmware. 


Characters appear dimmer after 
switching from 40 to 80 columns. 


Effect 


Application programs that called 
Monitor routines at non-standard 
places (that is, places other than 
the entry points listed in the 
Reference Manual) may no 
longer work. 


An 80-column text display may 
change more slowly during 
scrolling or updating. 


Characters are made up of 
smaller dots on the screen in 80 
columns than in 40 columns. 


What to Do 


The user may have such 
software; screen functions may 
work differently than expected, 
or not at all. The user should 
contact the software manufac- 
turer regarding updated versions 
of the product in question. 


The user should be aware of this 
known side effect. 


Readjust the brightness and 
contrast controls of the TV set or 
monitor if necessary. 


Programmer note: Table 4 illustrates the displayed characters for 
each range of codes in three display character sets: Apple Il and II 
Plus, Apple Ile Primary, and Apple Ile Alternate. The groups of char- 
acters are those enumerated in Table 1, notin Table 2. In other 
words, the Apple II and II Plus can display several characters not 
available on their keyboards ([ ,___ and their control-character 


counterparts). 


Table 4. Apple Il, Il Plus and Ile Displayed Character Sets 


Dec 0-31 32-63 
Hex 00-1F 20-3F 
I upper- special 
or case charac. 
I+ inverse inverse 
lle upper- special 
pri case charac. 
set inverse inverse 
lle upper- special 
alt case charac. 
set inverse inverse 








64-95 96-127 128-159 160-191 192-223 224-255 
40-5F 60-7F 80-9F* AO-BF CO-DF E0-FF 
upper- special upper- special upper- special 
case charac. case charac. case charac. 
flash flash normal normal normal normal 
upper- upper- special upper- 
case case charac. case 
flash normal normal normal 
upper- special upper- 
case charac. case 
normal normal normal 








* Ordinarily, the computer does not display control characters. 
However, if the codes corresponding to control characters occur in 
the display area of memory, they are displayed as uppercase. 
For example, the code generated by (contRoL)-(J) is displayed as J. 











For a full listing of the character codes, and descriptions of normal, 
inverse, flashing, primary and alternate character sets, refer to 
Chapter 2 of the Apple Ile Reference Manual. 


The differences among these character sets are: 


@ The lle primary character set substitutes the lowercase group for 
the special character group in the range 224-255. 


@ The Ile alternate character set makes the additional substitution 
of lowercase inverse for special characters flashing in the range 
96-127. (Bit 7 off is interpreted as inverse; no flashing characters 
are available in this character set.) 


You can switch between the primary and the alternate character set 
from software (Table 2-10 in the Apple Ile Reference Manual). 


Normally, the alternate character set is selected only when there is 
an Apple Ile 80-column card installed and active (turned on). 


Table 5 illustrates the groups of characters and display modes avail- 
able under various circumstances with the Apple II, II Plus and lle. 


Table 5. Allowable Display Modes 





Characters llor He Pri lle Alt Ile with 
Il Plus (no 80) (yes 80) Applesoft 
Normal uppercase/special Van uk N¢ Mf iv 
Inverse uppercase/special Nf Y ¥ Y 
Flashing uppercase/special \¢ Vf N Ve 
Normal lowercase N v6 Y Y 
Inverse lowercase N N Y. N 
Flashing lowercase N N N N 
Legend: 
Y = yes 


N = not available or displays incorrectly 

yes 80 = 80-column card both installed and active, or alternate character set 
selected by programmer 

no 80 = 80-column card either not installed or not active, or primary character set 
selected by programmer 


—_———————————— ee ee 

















Feature involved 


There is a built-in 9-pin 
connector on the back panel for 
hand controls. 


Feature involved 


It is possible to connect hand 
controls via the 9-pin back-panel 
connector or the GAME I/O 
connector. 


Rectangular openings replace 
the notches at the back of the 
Apple II and II Plus. 





Redesigned Back Panel 


Effect 


The user may have hand 
controls that have a 16-pin 
rectangular connector on them. 





What to Do 


The user can feed the 16-pin 
connector through one of the 
larger openings in the back panel 
and connect it to the GAME I/O 
connector on the main logic 
board. 


rr 


Caution 


If the user does this, conformance with FCC requirements cannot be 


guaranteed. 


a Ee a a ee dS) I en eT 
Note: For details, refer to the Cable and Connector Guide. 


Effect 


Programs may not run as 
expected when devices are 
attached to both the GAME I/O 
connector and the 9-pin hand 
control connector at the same 
time. 


The cord and connector of a 
peripheral device may not fit 
through the back panel 
Openings, and the cover cannot 
be closed tightly. 


What to Do 


The user may use one or the 
other of these two connectors at 
any given time, but not both. 


It may be necessary to purchase 
or fashion an adapter for the 
device connection. 


If the peripheral card was 
manufactured by Apple 
Computer, Inc., the user may be 
able to connect it using one of 
the nut plates from the Apple Ile 
accessories kit. 











Feature involved 


Both the maximum amount of 
RAM (64k) and the equivalent of 
the language card (now called 
bank-switched memory) are now 
available as standard equipment. 
Slot #0 is no longer present on 
the Apple lle. 


A 


Feature involved 


The Apple Ile has new and 
rearranged chips inside. 


The new AUX CONNECTOR 
slot is set off from the other 
slots because it has a different 
purpose than the other slots. 








Modified Main Logic Board 


Effect 


Those add-on cards that require 
installation in slot 0 or that 
require an extra connection on 
the main circuit board of an 
Apple II or Il Plus may not work 
with the Apple lle. 


What to Do 


Most add-on cards that work with 
the Apple II or II Plus also work 
with the Apple Ile. When in 
doubt, consult the manufacturer 
of the hardware product. 





Caution 


Do not plug cards intended for slot 0 into the AUX CONNECTOR slot. This 
may permanently damage the card or the computer. 


Effect 


Peripheral cards that had 
connections to chip sockets 
within the computer case may no 
longer be connectable. 


Because of the AUX CONNEC- 
TOR slot’s position away from 
the back edge of the computer 
case, cards designed for this slot 
can be inadvertently connected 
facing the wrong way. 


What to Do 


When in doubt, consult the 
manufacturer of the hardware 
product. 


Always install cards with the 
component side facing away 


‘from the power supply case 


(Owner's Manual, Chapter 1). If 
the cover does not close tightly, 
the card may have been installed 
incorrectly. 





Caution 


Install only cards that are specifically designed for this slot! 








Feature involved 


The Apple lle self-tests can be 
run at any time. (Gee Owner’s 
Manual, Chapter 8.) However, 
invoking them after running 
some other program may cause 
the tests to find unexpected 
values in main memory. 


The APPLE keys “modify” 
(CONTROL)-(RESET) and make it 
invoke other functions besides a 
simple reset. 


Additional Firmware 


Effect 


The Apple Ile self-tests may 
report errors (instead of 
displaying the KERNEL OK 
message) even when everything 
is OK. 


Pressing or locking the #0 or #1 
hand control buttons (which are 
connected to the APPLE keys) 
in their ON position may cause 
(CONTROL)-(RESET) to invoke 

the self-tests. 





What to Do 


If you see an error message on 
the screen after running the self- 
tests, turn off the computer, wait 
7 seconds or more, then turn the 
computer on again while holding 
down the (®) key. If you still get an 
error message, the computer 
may require servicing. 


Make sure the hand control 
buttons are off or the hand 
controls are disconnected when 
turning on the power or pressing 
(CONTROL)-(RESET), 








Interactions with Software 


This section lists the effects that the new features of the Apple Ile 
may have when you use various programs with it, along with the 


remedies available. 





Interaction of 


New full-reset feature and 
programs that rely on 
(CONTROL)-(RESET) to reach a 
menu, start up a second disk, 
and so on. 


80-Column Text Card and DOS 


Lowercase letters with DOS, 
Applesoft or Integer BASIC. 


80-Column Text Card and 
Applesoft. 


Effect 


(CONTROL)-(RESET) performs a full 
reset (that is, all 64K, including 
the “language card” area) rather 
than a partial reset (the low 48K) 
as the Apple II and II Plus did. 


Starting up DOS 3.3 turns off the 
80-column card firmware, 
causing the screen to display 
garbage. 


User constantly gets 5YNTAX 
ERROR message. 


Applesoft does not do “comma 
tabbing” beyond column 40. 


What to Do 


Procedures or programs that 
depend on the upper 16K of 
memory not being reset may not 
work; or you may have to start up 
such programs again to access a 
different menu directly. 


Turn the card back on by typing 
PR#8, or make sure it was off 
before you start up DOS. 


Press the key soit 
Clicks into its down position, so it 
converts all letters to uppercase; 
or use key. 


If the Apple Ile 80-Column Text 
Card is installed and active, you 
can use “uppercase restrict 


“mode” in BASIC or DOS; this 


forces uppercase except 
between quotation marks. 


This is not a problem with 
existing Apple Il or Il Plus 
programs written for a 40- 
column screen. 


Programmers: For “comma tabbing” beyond column 40, POKE location 
36 with the desired location for each tab in turn. 
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